home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / pmnsmerge.z / pmnsmerge
Text File  |  1998-10-20  |  5KB  |  131 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMNNNNSSSSMMMMEEEERRRRGGGGEEEE((((1111))))                                                      PPPPMMMMNNNNSSSSMMMMEEEERRRRGGGGEEEE((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmnnnnssssmmmmeeeerrrrggggeeee - merge multiple versions of a Performance Co-Pilot PMNS
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////ppppccccpppp////bbbbiiiinnnn////ppppmmmmnnnnssssmmmmeeeerrrrggggeeee [ ----aaaaddddffffvvvv ] _i_n_f_i_l_e [...]  _o_u_t_f_i_l_e
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      ppppmmmmnnnnssssmmmmeeeerrrrggggeeee merges multiple instances of a Performance Metrics Name Space
  16.      (PMNS), as used by the components of the Performance Co-Pilot (PCP).
  17.  
  18.      Each _i_n_f_i_l_e argument names a file that includes the root of a PMNS, of
  19.      the form
  20.                root {
  21.                    /* arbitrary stuff */
  22.                }
  24.      The order in which the _i_n_f_i_l_e files are processed is determined by the
  25.      presence or absence of embedded control lines of the form #define
  26.      _DATESTAMP YYYYMMDD
  27.  
  28.      Files without a control line are processed first and in the order they
  29.      appear on the command line.  The other files are then processed in order
  30.      of ascending _DATESTAMP.
  31.  
  32.      The ----aaaa option suppresses the argument re-ordering and processes all files
  33.      in the order they appear on the command line.
  34.  
  35.      The merging proceeds by matching names in PMNS, only those nnnneeeewwww names in
  36.      each PMNS are considered, and these are added after any existing metrics
  37.      with the longest possible matching prefix in their names.  For example,
  38.      merging these two input PMNS
  39.                root {                    root {
  40.                                              surprise  1:1:3
  41.                    mine       1:1:1          mine      1:1:1
  42.                    foo                       foo
  43.                                              yawn
  44.                    yours      1:1:2
  45.                }                         }
  46.                foo {                     foo {
  47.                    fumble     1:2:1
  48.                                              mumble    1:2:3
  49.                    stumble    1:2:2          stumble   1:2:2
  50.                }                         }
  51.                                          yawn {
  52.                                              sleepy    1:3:1
  53.                                          }
  54.  
  55.      Produces the resulting PMNS in _o_u_t.
  56.                root {
  57.                    mine      1:1:1
  58.  
  59.  
  60.  
  61.                                                                         PPPPaaaaggggeeee 1111
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68. PPPPMMMMNNNNSSSSMMMMEEEERRRRGGGGEEEE((((1111))))                                                      PPPPMMMMNNNNSSSSMMMMEEEERRRRGGGGEEEE((((1111))))
  69.  
  70.  
  71.  
  72.                    foo
  73.                    yours     1:1:2
  74.                    surprise  1:1:3
  75.                    yawn
  76.                }
  77.                foo {
  78.                    fumble    1:2:1
  79.                    stumble   1:2:2
  80.                    mumble    1:2:3
  81.                }
  82.                yawn {
  83.                    sleepy    1:3:1
  84.                }
  85.  
  86.      To avoid accidental over-writing of PMNS files, _o_u_t_f_i_l_e is expected to
  87.      not exist when ppppmmmmnnnnssssmmmmeeeerrrrggggeeee starts.  The ----ffff option forces the removal of
  88.      _o_u_t_f_i_l_e (if it exists), before the check is made.
  89.  
  90.      The ----dddd option allows the resultant PMNS to optionally contain duplicate
  91.      PMIDs with different names in the PMNS.  By default this condition is
  92.      considered an error.
  93.  
  94.      The ----vvvv option produces one line of diagnostic output as each _i_n_f_i_l_e is
  95.      processed.
  96.  
  97.      Once all of the merging has been completed, ppppmmmmnnnnssssmmmmeeeerrrrggggeeee will attempt to
  98.      compile the resultant namespace using ppppmmmmnnnnssssccccoooommmmpppp(1) - if this fails for any
  99.      reason, _o_u_t_f_i_l_e will still be created, but ppppmmmmnnnnssssmmmmeeeerrrrggggeeee will report the
  100.      problem and exit with non-zero status.
  101.  
  102. CCCCAAAAVVVVEEEEAAAATTTT
  103.      Once the writing of the new _o_u_t_f_i_l_e file has begun, the signals SIGINT,
  104.      SIGHUP and SIGTERM will be ignored to protect the integrity of the new
  105.      file.
  106.  
  107. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  108.      ppppmmmmnnnnssssccccoooommmmpppp(1), ppppmmmmnnnnssssaaaadddddddd(1), ppppmmmmnnnnssssddddeeeellll(1) and ppppmmmmnnnnssss(4).
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                                                                         PPPPaaaaggggeeee 2222
  128.  
  129.  
  130.  
  131.